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MESSAGING SERVICE IN A FEDERATED CONTENT MANAGEMENT SYSTEM 



FIELD OF THE INVENTION 
This invention relates in general to database management systems performed by 
computers, and in particular, to a messaging service in a federated content management system. 

5 BACKGROUND OF THE INVENTION 

The present invention relates to a system and method for representing and searching 
multiple heterogeneous datastores and managing the results of such searches. Datastore is a term 
used to refer to a generic data storage facility, such as a relational data base, flat-fde, hierarchical 
data base, etc. Heterogeneous is a term used to indicate that the datastores need not be similar to 
10 each other. For example, each datastore may store different types of data, such as image or text, 

or each datastore may be based on a different theory of data model, such as Digital 
-43 LibraiyA^isuallnfo or Domino Extended Search (DBS). 

HI For nearly half a century computers have been used by businesses to manage information 

such as numbers and text, mainly in the form of coded data. However, business data represents 
only a small part of the world's information. As storage, communication and information 

J processing technologies advance, and as their costs come down, it becomes more feasible to 

-J" digitize other various types of data, store large volumes of it, and be able to distribute it on 

fy demand to users at their place of business or home. 

New digitization technologies have emerged in the last decade to digitize images, audio, 

^ and video, giving birth to a new type of digital multimedia information. These multimedia 

objects are quite different from the business data that computers managed in the past, and often 
require more advanced information management system infrastructures with new capabilities. 
Such systems are often called "digital libraries." 

Bringing new digital technologies can do much more than just replace physical objects 

25 with their electronic representation. It enables instant access to information; supports fast, 

accurate, and powerfiil search mechanisms; provides, new "experiential" (i.e. virtual reality) user 
interfaces; and implements new ways of protecting the rights of information owners. These 
properties make digital library solutions even more attractive and acceptable not only to 
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corporate IS organizations, but to the information owners, publishers and service providers. 

Generally, business data is created by a business process (an airline ticket reservation, a 
deposit at the bank, and a claim processing at an insurance company are examples). Most of 
these processes have been automated by computers and produce business data in digital form 
5 (text and numbers). Therefore it is usually structured coded data. Multimedia data, on the 

contrary, cannot be fully pre-structured (its use is not fully predictable) because it is the result of 
the creation of a human being or the digitization of an object of the real world (x-rays, 
geophysical mapping, etc.) rather than a computer algorithm. 

The average size of business data in digital form is relatively small. A banking record - 

10 including a customers name, address, phone number, account number, balance, etc.-represents at 
most a few hundred characters, i.e. few hundreds/thousands of bits. The digitization of 
multimedia information (image, audio, video) produces a large set of bits called m "object" or 

O "blobs" (Binary Large Objects). For example, a digitized image of the parchments from the 

^ j Vatican Library takes as much as the equivalent of 30 miUion characters (30 MB) to be stored. 

JijS The digitization of a movie, even after compression, may take as much as the equivalent of 

M several bilhons of characters (3-4 GB) to be stored. 

"r. Multimedia information is typically stored as much larger objects, ever increasing in 

^ quantity and therefore requiring special storage mechanisms. Classical business computer 

flj systems have not been designed to directly store such large objects. Speciahzed storage 
t-20 technologies may be required for certain types of information, e.g. media streamers for video or 
u music. Because certain multimedia information needs to be preserved "forever" it also requires 

special storage management functions providing automated back-up and migration to new 

storage technologies as they become available and as old technologies become obsolete. 

Finally, for performance reasons, the multimedia data is often placed in the proximity of 
25 the users with the system supporting multiple distributed object servers. This often requires a 

logical separation between application programs, indices, and data to ensure independence from 

any changes in the location of the data. 

The indexing of business data is often imbedded into the data itself When the automated 

business process stores a person's name in the column "NAME," it actually indexes that 
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information. Multimedia information objects usually do not contain indexing information. This 
"meta data" needs to be created in addition by developers or librarians. The indexing 
information for multimedia information is often kept in "business like" databases separated from 
the physical object. 

5 In a Digital Library (DL), the multimedia object can be linked with the associated 

indexing information, since both are available in digital form. Integration of this legacy catalog 
information with the digitized object is crucial and is one of the great advantages of DL 
technology. Different types of objects can be categorized differently as appropriate for each 
object type. Existing standards hke MARC records for libraries, Finding Aids for archiving of 
10 special collections, etc... can be used when appropriate. 

The indexing information used for catalog searches in physical libraries is mostly what 
one can read on the covers of the books: authors name, title, publisher, ISBN,.,, enriched by 
0 other information created by librarians based on the content of the books (abstracts, subjects, 
Q keywords,...). In digital libraries, the entire content of books, images, music, films, etc.. are 
35 available and "new content" technologies are needed; technologies for full text searching, image 
content searching (searching based on color, texture, shape, etc..,), video content searching, and 
audio content searching. The integrated combination of catalog searches (e.g. SQL) with content 
: searches will provide more powerful search and access functions. These technologies can also be 

fij used to partially automate further indexing, classification, and abstracting of objects based on 
^13 content. 

O To harness the massive amoimts of information spread throughout these networks, it has 

become necessary for a user to search numerous storage facilities at the same time without 
having to consider the particular implementation of each storage facility. 

Object-oriented approaches are generally better suited for such complex data 

25 management. The term "object-oriented" refers to a software design method which uses "classes" 
and "objects" to model abstract or real objects. An "object" is the main building block of object- 
oriented programming, and is a programming unit which has both data and fimctionality (i.e., 
"methods"). A "class" defines the implementation of a particular kind of object, the variables 
and methods it uses, and the parent class it belongs to. 
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Some known programming tools that can be used for developing search and result- 
management frameworks include IBM VisualAge Microsoft Visual C++, Microsoft Visual 
J++, and Java. 

Messaging is an important element for developing sensible appUcation programs in 
5 enterprise computing. Conventional federated content management systems do not provide a 

messaging capability for application program development. Without this messaging capability, it 
is difficult to communicate between two geographically remote application programs in a 
federated content management system. 

Furthermore, messaging is critical to applications in a federated content management 
1 0 system that consists of various heterogeneous back-end servers (e.g., Digital Library, 

OnDemand, ImagePlus 390, etc.). A typical federated search may return a search result Ust 
containing a collection of data fi-om different servers. Without the messaging capability, it is not 
^ easy to send the federated search results from one application program to another application 
'^=J program. 

§;j5 Lastly, event notification is essential in coordinating concurrent application programs in a 

3;; federated content management system. Without the messaging capability, it would be difficult to 
yo implement event notification between two geographically remote application programs in a 

federated content management system. 
0=^ There is a need in the art for an improved federated content management system, hi 

rio particular, there is a need in the art for a messaging service in a federated content management 
i:- system. 

SUMMARY OF THE INVENTION 
To overcome the limitations in the prior art described above, and to overcome other 
limitations that will become apparent upon reading and understanding the present specification, the 
25 present invention discloses a method, apparatus, and article of manufacture for a messaging service 
in a federated content management system. 

According to an embodiment of the invention, a technique for communicationbetween a first 
computer and a second computer, each of which is connected to a server computer, is described. 
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Under control of a first application at the first computer, a message is created, wherein the message 
comprises zero or more text and zero or more content identifiers, and the message is put into a 
message queue. Under control of a second application at the second computer, the message is 
retrieved from the message queue. 

BRIEF DESCRIPTION OF THE DRAWINGS 
Referring now to the drawings in which like reference numbers represent corresponding parts 
throughout: 

FIG. 1 is a diagram illustrating a computer architecture that could be used in accordance with 
the present invention; 

FIG. 2 is a diagram illustrating a class hierarchy for Data Object classes; 

FIG. 3 is a diagram illustrating a class hierarchy for Datastore classes; 

FIG. 4 is a diagram illustrating one composition of a federated datastore; 

FIG. 5 schematically illustrates a hardware environment of an embodiment of the present 
invention; and 

FIG. 6 provides an overview of processing with the messaging service system. 

DETAILED DESCRIPTION 
In the following description of embodiments of the invention, reference is made to the 
accompanying drawings which form a part hereof, and in which are shown by way of illustration 
specific embodiments in which the invention may be practiced. It is to be understood that other 
embodiments may be utihzed and structural and functional changes may be made without departing 
from the scope of the present invention. 

Federated Content Management System 
A. Federated Architecture 

FIG. 1 is a diagram illustrating a computer architecture that could be used in accordance with 
the present invention. The present invention is described herein by way of example and is not 
intended to be hmited to the described embodiment. The description of one embodiment 
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is based on, but certainly not limited to, the IBM design of Java Grmd Portal Class Library, the 
Digital Library Java Application Programming Interface (API). 

The Java Grand Portal 120 is comprised of client and server classes. In particular, Java 
Grand Portal is a set of Java classes which provides access and manipulation of local or remote data 
stored in Digital Library storage facilities. It uses a Java API based on OMG-Object Query Services 
(OQS) and a Dynamic Data Object protocol, v^hich is apart of OMG/Persistence Object Services. 

The Java API provides multi-search capabilities such as: 

1 . Searching within a given datastore using one or a combination of supported query 
types, i.e., 

Parametric query - Queries requiring an exact match on the condition specified in the 
query predicate and the data values stored in the datastore. 

Text query - Queries on the content of text fields for approximate match with the given 
text search expression, e.g. the existence (or non-existence) of certain phrases or word- 
stems. 

Image query - Queries on the content of image fields for approximate match with the 
given image search expression, e.g. image with certain degree of similarity based on 
color percentages, layout, or texture. 

2. Each search type is supported by one or more search-engines. 

3 . Searching on the results of a previous search. 

4. Searching involving heterogeneous datastores. 

The Digital Library Grand Portal classes provide a convenient API for Java application users; 
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the applications can be located at local or remote sites. Java classes will typically reside on both 
server and client sides; both sides providing the same interface. The client side of Java classes 
communicates with the server side to access data in the Digital Library through the network. 
Communication between chent and server sides is done by these classes; it is not necessary to add 
any additional programs. 

In particular, FIG 1 is an architectural diagram outlining the structure of the federated search 
for Digital Library repositories using the federated datastore 1 00, comprised of a federated datastore 
client and server. A federated datastore 100 is a virtual datastore which combines several 
heterogeneous datastores 102 into a consistent and unified conceptual view. This view, or a 
federated schema, is established via schema mapping 104 of the underlying datastores. The users 
interact with a federated datastore 100 using the federated schema, without needing to know about 
the individual datastores 102 which participate in the federated datastore 100. 

One embodiment of the invention provides a password system that supports password 
encryption and decryption for user authentication in a federated content management system. In one 
embodiment of the invention, one or more programs or functions implement the password system. 
In one embodiment, these programs and functions reside at the federated datastore. 

The federated datastore 100 does not have a corresponding back-end client. Since it is a 
virtual datastore, the federated datastore 100 relies on the underlying physical back-end cUent 
associated with it, such as the DL chent (i.e., Digital Library chent), OnDemand, Visuallnfo, etc. 
As mentioned before, this association is established by a schema mapping component 104. 

The communication between the federated datastore 1 00 chent and server can be done by any 
appropriate protocol. On top of Java Grand Portal client classes, the users can develop apphcation 
programs using, for example, any existing Java Beans 122 development environment. 

The federated datastore 100 coordinates query evaluation, data-access, and transaction 
processing of the participating heterogeneous datastores 102. Given the federated schema, a multi- 
search query can be formulated, executed, and coordinated to produce results in the form of a 
datastore-neutral dynamic data object. 

Note that each heterogeneous datastore and the federated datastore art created using one 
datastore definition. The federated datastore 100 and the heterogeneous datastores 102 are all 
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subclasses of a class called Datastore, therefore, all of these datastores 100 and 102 have the same 
interface. Therefore, a user would be able to access the federated datastore 100 and the 
heterogeneous datastores 102 in a consistent and uniform manner. 

Additionally, the objects stored in the federated datastore 100 and the heterogeneous 
datastores 102 are subclasses of an Object class. The Object class includes subclasses for dynamic 
data objects (DDOs) and extended data objects (XDOs). A DDO has attributes, with type, value, 
and properties. The value of an attribute can be a reference to another DDO or XDO, or a collection 
ofDDOsorXDOs. 

FIG. 2 is a diagram illustrating a class hierarchy for Data Object classes. The objects stored 
in and manipulated by the datastores and fetch operations belong to data object classes. These 
objects are returned as the result of a fetch, or created and used in CRUD (add, retrieve, update, 
delete) operations. 

A DataObjectBase 200 is an abstract base class for all data objects known by datastores. It 
has a protocol attribute, that indicates to the datastore which interface can be used to operate on this 
object. A XDOBase 210 is the base class used to represent user-defmed-types (UDT) or large 
objects. In particular, the XDOBase 210 is the base class for some user-defined types 212 and 
XDOs 214. A XDO 214 represents complex UDTs or large objects (LOB). This object can exist 
stand-alone or as a part of a DDO 236. Therefore, it has a persistent object identifier and CRUD 

operations capabilities. 

Blob 216 is abase class for BLOBs as a placeholder to share all generic operations pertaining 
to BLOBs. Clob 218 is abase class for CLOBs (Character Large Objects) as a placeholder to share 
all generic operations pertaining to CLOBs. DBClob 220 is abase class for DBCLOBs (database 
character large object) as a placeholder to share all generic operations pertaining to DBCLOBs. 
BlobDB2 222 represents a BLOB specific to DB2, and BlobDL 22 represents a BLOB specific to 
DL. Similarly, though not shown, there may be subclasses for ClobDB2, ClobDL, etc. 

A DataObject 230 is a base class for PersistentObject 232 and DDOBase 234. A 
PersistentObject 232 represents a specific object whose code is statically generated and compiled. 
This type of object will not be covered in this document. A DDOBase 234 is a base class for a 
dynamic data object 236 (without the CRUD methods). A DDO (Dynamic Data Object) 236 
represents generic data objects which are constructed dynamically at runtime. This object fits well 
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with query and browsing activities in Portal where objects are only known and generated at runtime. 
It supports the CRUD operations (add, retrieve, update, and delete), and, with the help of its 
associated datastore, a DDO can put itself into and out of the datastore. 

One skilled in the art would recognize that these are only example classes and subclasses and 
5 other structures maybe used for objects and other classes or subclasses may be added to or removed 
from the tree shown in FIG, 2. 

With respect to the notion of "federation", each participating datastore preserves the right to 
maintain its "personality", i.e. its own query language, data-model or schema, method of interaction, 
etc, and at the same time cooperating in a federation to provide a federated schema. This design 
10 allows the users to preserve the natural view to their favorite datastore as well as access them in 
conjunction with other datastores in a federated context. 

The federated datastore 100 can combine the participating native datastores in two ways: 

"^j With mapping. As described above, mapping of concepts across participating datastores is 

%l estabhshed to provide a unified conceptual view. Based on this federated schema, 

J§ federated queries with both join and union expressions can be formulated. 

r , Without mapping. In this case, the federated datastore 100 only reflects the union of each 

participating datastore's conceptual view. Although it coordinates query processing and 
m data-access for each underlying datastore, the federated datastore 1 00 must accept queries 

in each datastore's native language since the query translation process can not be 
20 performed without mapping. In addition, since there is no conceptual mapping between 

datastores, the FederatedQuery 19 results can only reflect the union of results from each 

datastore. 



The embodiment of the invention is incorporated into one or more software programs that 
reside at the federated datastore 100. Generally, the software programs and the instructions derived 
25 therefrom, are all tangibly embodied in a computer-readable medium, e.g. one or more of the data 
storage devices, which may be connected to the federated datastore 100, Moreover, the software 
programs and the instructions derived therefrom, are all comprised of instructions which, when read 

: :ODM A\PCDOCS\DOCS\2639 1 \5 STL000044US 1 

IBMST-044764 9 



and executed by the computer system 100, causes the computer system 100 to perform the steps 
necessary to implement and/or use the present invention. Under control of an operating system, the 
software programs and the instructions derived therefrom, may be loaded from the data storage 
devices into a memory of the federated datatstore 100 for use during actual operations. 

Thus, the present invention may be implemented as a method, ^paratus, or article of 
manufacture using standard programming and/or engineering techniques to produce software, firmware, 
hardware, or any combination thereof The term "article of manufacture" (or alternatively, "computer 
program product") as used herein is intended to encompass a computer program accessible from any 
computer-readable device, carrier, or media. Of course, those skilled in the art will recognize many 
modifications may be made to this configuration without departing from the scope of the present 
invention. 

Those skilled in tiie art will recognize that the exemplaiy environment illusfrated in FIG. 1 is not 
intended to limit the present invention, hideed, those skiUed in the art will recognize that other 
alternative hardware environments may be used without departing from the scope of the present 
invention. 



B. Federated Datastore 

FIG. 3 isadiagram illustratingaclass hierarchy for Datastoreclasses. A main datastore class 300 
is an abstract base class (i.e., superclass) for all datastores. In particular, some datastore classes that are 
based on the datastore class 300 and inherit its characteristics are the following: a DL Datastore class 
302, a Visuallnfo Datastore class 304, a Federated Datastore class 306, and an OnDemand Datastore class 
308. 

FIG. 4 is a diagram illustrating one composition of a federated datastore. The federated datastore 
400 connects to heterogeneous datastores 402, 404, 406, and 408. As illusfrated, a federated datastore 406 
may connect to and be nested under federated datastore 400. Additionally, the federated datastore 406 
may connect to heterogeneous datastores 41 0, 412, and 41 4. The depicted architecture is only a sample, 
and one skilled in the art would recognize that other examples fall within the scope of the invention. 

In the preferred embodiment, the federated datastore 100 takes query strings expressed in a 
federated query language. An example class definition for DatastoreFederated 100 is set forth below. 
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DKDatastoreFedjava 



package com.ibin.niin.sdk,server; 

public class DKDatastoreFed extends dkAbstractDataStore 
implements DKConstantFed, 
DKConstant, 
DKMessageldFed, 
DKMessageld, 
dkFederation, 
javaio.Serializable 

{ 

public dkCoUection listEntitiesQ throws DKException, Exception 
public String[] listEntityNamesQ throws DKException, Exception 
public String[] listTextEntityNamesQ throws DKException, Exception 
public String[] listParmEntityNamesO throws DKException, Exception 
public dkCoUection listEntityAttrs(String entityName) throws DKException, Exception 
public StringO listEntityAttrNames(String entityName) throws DKException, Exception 
public String registerMapping(DKNVPair sourceMap) throws DKException, Exception 
public void unRegisterMapping(String mappingName) throws DKException, Exception 
public String[] listMappingNamesQ throws DKException, Exception 
public dkSchemaMapping getMapping(String mappingName) throws DKExcq>tion, 
Exception 

public synchronized dkExtension getExtension(String extensionName) throws 

DKException, Exception 
public synchronized void addExtension(String extensionName, 

dkExtension extensionObj) throws DKException, Exception 
public synchronized void removeExtension(String extensionName) throws DKException, 

Exception 

public synchronized String[] listExtensionNamesQ throws DKException, Exception 
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public DKDDO createDDO(String objectType, 

int Flags) throws DKException, Exception 
public dkCoUection listSearchTemplatesO throws DKException, Exception 
public String[] listSearchTemplateNamesQ throws DKException, Exception 
public dkSearchTemplate getSearchTemplate(String templateName) throws DKException, 
Exception 

pubUc void destroyO throws DKException, Excq)tion 

public synchronized string addRemoveCursor (dkResultSetCursor iCurt int action) 

throws DKException, Exception 
public dkDatastore datastoreByServerName (String dsType, String dsName) 

throws DKException, Exception 
public void changePassword (String serverName, 

String user Id, 

String oldPwd, 

String newPwd) 

throws DKException, Exception 
public void requestConnection (String serverName, 

String userld. 

String passwd, 

String connectString) 

throws DKException, Exception 
public void excludeServer (Sting serverName, String templateName) 

throws DKException, Exception 
public boolean isServerExcluded (String serverName, String templateName) 

throws DKException, Exception, java.nni.RemoteException 
public String[] listExcludedServers(String templateName) throws DKException, 

Exception 

public void clearExcludedServers(String templateName) throws DKException, Exception 
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The following methods are part of the federated datastore class: 
public DKDatastoreFedQ throws DKException, Exception 

Constructs default Federated Datastore, 
public DKDatastoreFed(String configuration) throws DKException, Exception 

Constructs default Federated Datastore, 

public void connect(String datastore jtame, 
String userjiame, 
String authentication, 

String connect_string) throws DKException, Exception 
EstabUshes a comection to a federated datastore. 
Parameters: 

datastore_name - federated datastore name 
user_name - userid to logon to this federated datastore 
authentication - password for this user_name 
connect_string - additional information string 
Throws: DKException 
if either: 

datastore__name, user_name, or authentication is null 
or if error occurs in the federated datastore 
Overrides: 

connect in class dkAbstractDatastore 



::ODMA\PCDOCS\DOCS\26391\5 
IBMST-044764 



13 



public void discomectQ throws DKException, Exception 
Disconnects from the federated datastore. 

Throws: DKException 

if unable to disconnect from server. 

5 Overrides: 

disconnect in class dkAbstractDatastore 

public Object getOption(int option) throws DKException 

Gets defined datastore option 

H Parameters: 

4p option - an option id 

J;i Returns: 

=1- the value for the given option 

^] Throws: DKException 

: ^ if option is not set 

fl5 Ovmides: 

Hi getOption in class dkAbstractDatastore 

public void setOption(int option, Object value) throws DKException 

Sets the given "option" with a specific "value". 
Parameters: 

20 option - an option id 

value - the value for the "option" 
Throws: DKException 

if option/value is invalid 
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Overrides: 



setOption in class dkAbstractDatastore 

public Object evaluate(String command, 
short commandLangType, 
5 DKNVPair paramsfj) throws DKException, Exception 

Evaluates a query and returns the result as a dkQueryableCoUection object. 

Parameters: 

command - a query stimg that represent the query criteria 
commandLangType - a query language type, for Federated, it will be 

II) Dl^EDERATEDJ^LTYPE 

s\ params - a name/value pairs list 

z,: Retums: 

4S a query result collection 

Throws: DKException 
f 1 5 if "command" argument is null 

fli Overrides: 

evaluate in class dkAbstractDatastore 
public Object evaluatefdkQuery query) throws DKException, Exception 

Evaluates a query and retums the result as a DKAny containing dkQueryableCoUection, 
20 Parameters: 

query - a given query object 

Retums: 

a query result collection 
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Throws: DKException 

if the "query" input is null or not of federated query type. 

Overrides: 

evaluate in class dkAbstractDatastore 
public Object evaluate(DKCQExpr qe) throws DKException, Exception 
Evaluates a query. 
Parameters: 

qe - a conmion query expression object 

Returns: 

a collection of the results 
Throws: DKException 

if common query expression object is invalid 

Overrides: 

evaluate in class dkAbstractDatastore 

public dkResultSetCursor execute(String command, 
short commandLangType, 

DKNVPair paramsfj) throws DKException, Exception 
Executes a command query of the federated datastore and returns a result set cursor. 
Parameters: 

command - a query string that represents the query criteria. 
commandLangType - a query language type, for Federated, it will be 

DK_FEDERATED_QL__TYPE. 
params[] - a name/value pairs list. 
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Returns: 

a dkResultSetCursor object. 
Throws: DKException 

if "command" is null or invalid, or "commandLangType" is not Federated 

Query type. 

Overrides: 

execute in class dkAbstractDatastore 

public dkResultSetCursor execute(dkQuery query) throws DKException, Exception 

Executes a command query of the federated datastore and returns a result set cursor. This 
method takes a Federated query object as an argument. 

Parameters: 

query - a federated dkQuery object 

Returns: 

a dkResultSetCursor object 
Throws: DKException 

if "query" object is null or query.qlTypeQ is not DK_FEDERATED_QL_TYPE 

Overrides: 

execute in class dkAbstractDatastore 
public dkResultSetCursor execute(DKCQExpr cqe) throws DKException, Exception 
Executes a query expression. 
Parameters: 

cqe - a common query expression object 

Returns: 

resultSetCursor which represents a federated datastore cursor. 
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Throws: DKExcq)tion 

if "cqe" object is invalid 

Overrides: 

execute in class dkAbstractDatastore 

5 public void executeWithCallback(dkQuery query, 

dkCallback callbackObj) throws DKException, Exception 

Executes a query with callback function. 

Parameters: 

query - a query object 
ttb callbackObj - a dkCallback object 

Q Overrides: 

'i: executeWithCallback in class dkAbstractDatastore 

public void executeWithCallback(String command, 
f short commandLangType, 

m DKNVPairparamsfJ, 

dkCallback callbackObj) throws DKException, Exception 

Execute the query with callback function. 

Parameters: 

command - a query string 
20 commandLang - a query type 

params - additional query option in name/value pair 
callbackObj - a dkCallback object 

Overrides; 

executeWithCallback in class dkAbstractDatastore 
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public void executeWithCallback(DKCQExpr cqe, 

dkCallbackcallbackOhj) throws DKException, Exception 



Execute a query expression with callback function. 
Parameters: 

cqe - a common query expression object 
callbackObj - a dkCallback object 

Overrides: 

executeWithCallback in class dkAbstractDatastore 

public dkQuery createQuery(String command, 
short commandLangType, 
DKNVPair paramsf]) throws DKException 

Creates a federated query object. 

Parameters: 

command - a query string that represents the query criteria 
commandLangType - a query language type, it will be one of the 
following: 

DK_CM_TEMPLATE_QL_TYPE 
DK_CM_TEXT_QL_TYPE 
DK_CM„IMAGE_QL_TYPE 
DK_CM„PARAMETRIC_QL_TYPE 
DK_CM_.COMBINED_QL_TYPE 
params[] - a name/value pairs list 

Returns: 

a federated dkQuery object 
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Throws: DKException 

if "command" is null 

Overrides: 

createQueiy in class dkAbstractDatastore 
5 public dkQuery createQuery(DKCQExpr qe) throws DKException 
Creates a query object. 
Pai*ameters: 

cqe - a common query expression object 
Throws: DKException 
plO if "cqe" object is invalid 

Overrides: 

yi createQueiy in class dkAbstractDatastore 

public dkCollection listDataSourcesQ throws DKException 
nj List the available datastore sources that a user can connect to. 

'45 Returns: 

a collection of ServerDef objects describing the servers 
Throws: DKException 

if internal error occurs from server 

Overrides: 

20 listDataSources in class dkAbstractDatastore 
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public StringO HstDataSourceNamesQ throws DKException 
Gets a list of datasource names. 
Returns: 

an array of datasource names 
Throws: DKException 

if error occurs when retrieving datasource names 

Overrides: 

listDataSourceNames in class dkAbstractDatastore 

public void addObject(dkDataObject dataobj) throws DKException, Exception 

Adds a DDO object - since federated datastore does not allow adding object 
dynamically, this method will throw DKUsageError exception. 

Parameters: 

ddo - a Federated object to be added. 
Throws: DKException 

is thrown for all calls to this method. 

Overrides: 

addObject in class dkAbstractDatastore 
public void deleteObject(dkDataObject dataobj) throws DKException, Exception 
Deletes a data object. 
Parameters: 

ddo - a federated DDO object to be deleted 
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Throws: DKExcq)tion 

since Federated server does not support deletion of documents for now. 

Overrides: 

deleteObject in class dkAbstractDatastore 

5 public void retrieveObject(dkDataObject dataobj) throws DKException, Exception 
Retrieves a data-object. 
Parameters: 

ddo - document object to be retrieved. 
Throws: DKException 
OK) when retrieve Med, 

Overrides: 

If j retrieveObject in class dkAbstractDatastore 

public void updateObject(dkDataObject dataobj) throws DKException, Exception 
m Updates a data-object. 

35 Parameters: 

ddo - the data-object to be updated. 
Throws: DKException 

if error occurs in the datastore 

Overrides: 

20 updateObj ect in class dkAbstractDatastore 
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public void commitQ throws DKException 



Commits all activities since the last commit. This method will do nothing for federated since 
this datastore does not support commit/rollback fixnctions. 

Throws: DKException 

is thrown since federated datastore does not support transaction scope for now. 

Overrides: 

commit in class dkAbstractDatastore 

public void rollbackQ throws DKException 

Rolls back all activities since the last commit. This method will do nothing 
for federated datastore since it does not support commit/rollback fimctions yet. 

Throws: DKException 

is thrown since Federated does not support transaction scope for now. 

Overrides: 

rollback in class dkAbstractDatastore 

public boolean isConnectedQ 

Checks to see if the datastore is connected 

Returns: 

tme if connected, false otherwise 

Overrides: 

isConnected in class dkAbstractDatastore 
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public DKHandle connectionQ throws Exception 

Gets the connection handle for the datastore. 
Returns: 

the connection handle 

Overrides: 

connection in class dkAbstractDatastore 
public DKHandle handle(String type) throws Exception 
Gets a datastore handle. 
Parmieters: 

type - type of datastore handle wanted 

Returns: 

a datastore handle 

Overrides: 

handle in class dkAbstractDatastore 
public String userNameQ 

Gets the user name that user used to logon to the datastore. 
Returns: 

the userid that user used to logon 

Overrides: 

userName in class dkAbstractDatastore 
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public String datastoreNameQ throws Exception 

Gets the name of this datastore object Usually it represents a datastore source^s server name. 
Returns: 

datastore name 

5 Overrides: 

datastoreName in class dkAbstractDatastore 

public String datastoreTypeQ throws Exception 

Gets the datastore type for this datastore object. 

Q Returns: 

W) datastore type 

J" Overrides: 

datastoreType in class dkAbstractDatastore 
IJ public dkDatastoreDef datastoreDefQ throws DKException, Exception 
P Gets datastore definition, 

15 Returns: 

the meta-data (dkDatastoreDef) of this datastore 

Overrides: 

datastoreDef in class dkAbstractDatastore 
public dkCollection listEntitiesQ throws DKException, Exception 
20 Gets a list of federated entities fi-om Federated server. 
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Retxims: 

a collection of dkEntityDef 
Throws: DKException 

if error occurs 

Overrides: 

listEntities in class dkAbstractDatastore 
public Stringf] listEntityNamesQ throws DKException, Exception 

Gets a list of federated entities names from Federated server. 
Returns: 

an array of names 
Throws: DICException 

if error occurs 

Overrides; 

hstEntityNames in class dkAbstractDatastore 
public Stringf] listTextEntityNamesQ throws DKException, Exception 

Gets a list of federated text search entities names from Federated server. 
Returns: 

an array of names 
Throws: DKException 

if error occurs 

public Stringf] listParmEntityNamesQ throws DKException, Exception 

Gets a list of federated parametric search entities names from Federated server. 
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Returns: 

an array of names 
Throws: DKException 

if error occurs 

Overrides: 

listEntityAttrs 

public dkCollection listEntityAttrsfString entityName) throws DKException, Exception 
Gets a list of attributes for a given entity name. 
Parameters: 

entityName - name of entity to retrieve attributes for 

Retums: 

a dkCollection of dkAttrDef objects 
Throws: DKException 

if the entity name does not exist 

Overrides: 

listEntityAttrs in class dkAbstractDatastore 
public StringfJ listEntityAttrNames(String entityName) throws DKException, Exception 
Gets a list of attribute names for a given entity name. 
Parameters: 

entityName - name of entity to retrieve attribute names for 

Retums: 

an array of attribute names 
Throws: DKException 

if the entity name does not exist 
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Overrides: 

listEntityAttrNames in class dkAbstractDatastore 
public String registerMapping(DKNVPair sourceMap) throws DKException, Exception 
Registers a mapping definition to this datastore. Mapping is done by entities. 
P^ameters: 

sourceMap - source name and moping, a DKNVPair class with the following 

possible values: 

("BUFFER", ) : buffer^ref is a reference to a string in memory 
("FILE", ) : file_name is the name of the file containing the 
mapping 

("URL", ) : URL-address location of the mapping 
("LDAP", ) : LDAP file-name 

("SCHEMA", ) : a reference to a dkSchemaMapping object defining 



the 



maybe 



Returns: 



mapping. Currently, only "SCHEMA" option is supported, others 



added later. 



the name of the mapping definition. 

Overrides: 

registerMapping in class dkAbstractDatastore 

See Also: 

unRegisterMapping 

public void unRegisterMapping(String mappingName) throws DKException, Exception 
Unregisters mapping information fi-om this datastore. 
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Parameters: 

mappingName - name of the mapping information 

Overrides: 

unRegisterMapping in class dkAbstractDatastore 

See Also: 

registerMapping 

public Stringf] listMappingNamesQ throws DKException, Exception 
Gets the list of the registered mappings for this datastore. 
Returns: 

an array of registered mapping objects' names. The array length would be 
zero if there is no mapping registered. 
Overrides: 

listMappingNames in class dkAbstractDatastore 

See Also: 

registerMapping 

public dkSchemaMappinggetMapping(String mappingName) throws DKException, Exception 
Gets mapping information from this datastore. 
Parameters: 

mappingName - name of the mapping information 

Returns: 

the schema mapping object 

Overrides: 

getMapping in class dkAbstractDatastore 
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See Also: 

registerMapping 

public synchronized dkExtension getExtension(String extensionName) throws DKException, 
Exception 

Gets the extension object from a given extension name. 
Parameters: 

extensionName - name of the extension object. 

Returns: 

extension object. 

Overrides: 

getExtension in class dkAbstracfDatastore 

public synchronized void addExtension(String extensionName, 

dkExtension extensionObj) throws DKException, Exception 

Adds a new extension object. 

Parameters: 

extensionName - name of new extension object 
extensionObj - the extension object to be set 

Overrides: 

addExtension in class dkAbstractDatastore 

public synchronized void removeExtension(String extensionName) throws DKException, 
Exception 

Removes an existing extension object. 
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Parameters: 

extensionName - name of extension object to be removed 

Overrides: 

removeExtension in class dkAbstractDatastore 
public synchronized StringO listExtensionNamesQ throws DKException, Exception 
Gets the list of extension objects' names. 
Retums: 

an array of extension objects' names 

Overrides: 

listExtensionNames in class dkAbstractDatastore 

public DKDDO createDDO(String objectType, 

int Flags) throws DKException, Exception 

Creates a new DDO with object type, properties and attributes set for a given back-end 
server. 

Parameters: 

objectType - the object type 
Flags - to indicate various options and to specify more detailed characteristics of the DDO to 
create. For example, it may be a directive to create a document DDO, a folder, 
etc. 

Retums: 

a new DDO of the given object type with all the properties and 
attributes set, so that the user only needs to set the attribute values 

Overrides: 

createDDO in class dkAbstractDatastore 
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public dkCollection listSearchTemplatesQ throws DKException, Exception 
Gets a list search templates from a federated server. 
Returns: 

a DKSequentialCoUection of search templates 
Throws: DKException 

if intemal datastore error occurs 

public StringfJ listSearchTemplateNamesQ throws DKException, Exception 

Gets a Ust search templates' names from a federated server. 

Returns: 

an array of search template names 
Throws: DKException 

if internal datastore error occurs 

public dkSearchTemplate getSearchTemplate(String templateName) throws DKException, Exception 

Gets a search template information from a given template name. 

Returns: 

dkSearchTemplate object. 
Throws: DKException 

if intemal datastore error occurs 

public void destroy Q throws DKException, Exception 

datastore destroy - datastore cleanup if needed 
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Overrides: 

destroy in class dkAbstractDatastore 

public synchronized string addRemoveCursor (dkResultSetCursor iCurt int action) 
throws DKException, Exception 



public dkDatastore datastoreByServerName (String dsType, String dsName) 
throws DKException, Exception 

Gets a reference to the specified datastore. The datastore must be connected, otherwise it will 
return null even if one is found. First, it will look in the fi*ee connection pool. If none found, it will 
look under the coimection pool held by active cursors. 

Parameters: 

<action> consider the case when transaction is active 

public void changePassword (String serverName, 
String user Id, 
String oldPwd, 
String newPwd) 
throws DKException, Exception 

Changes the password of a given user Id for a specified server. Administrator oiily function. 
Parameters: 

userld - the user-id 
oldPwd - the old password 
newPwd -the new password 
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public void requestConnection (String serverName, 
String userld, 
String passwd. 
String connectString) 
throws DKException, Exception 

Requests a connection to a particular server with the given userid, password & connectString. 



Parameters: 



userld 



-the user Id 



passwd -the password 

connectString - the connect string to logon 



public void excludeServer (Sting serverName, String templateName) 
throws DKException, Exception 



Requests the named server to be skipped for the named search template. 



Parameters: 



serverName 



- a back end server name 



templateName - a search template name 



public boolean isServerExcluded (String serverName, String templateName) 
throws DKException, Exception, java,rmiRemoteException 



Checks if the given server is in the excluded list for the named search template. 



Parameters: 



serverName 



- a back end server name 



templateName - a search template name 
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Returns: 

true or false 

public StringfJ listExcludedServers(String templateName) throws DKException, Exception 
Lists all the excluded servers for the named search template 
Parameters: 

s - templateName - a search template name 

Returns: 

an array of server names that were excluded during search 
public void clearExcludedServers(String templateName) throws DKException, Exception 
Clears all the excluded servers for the named search template 
Parameters: 

s - templateName - a search template name 

The foUovraig is sample syntax of a federated query string. However, it is to be understood 
that other syntax, including other parameters, may be used for the federated query string without 
departing from the scope of the invention. 

PARAMETRIC_SEARCH=([ENTITY=entity_nameJ 
[MAX_RESULTS=maximum_results,] 
[COND=(conditional_expression)] 

[; •..] 

); 

[OPTIONK[CONTENT=yes_no] 
)] 
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[and_or 



TEXT_SEARCH=(COND=(text_search_expression) 

); 

[OPTIONK[SEARCH_IM)EX={search_mdex_name | (mdex_]ist) };] 
[MAX_RESULTS=maximimi_results;] 
[TIME_LIMIT=time_liinit] 

)] 

] 

[andor 

IMAGE_SEARCH=(COND=(image_search_expression) 

); 

[OPTION=([SEARCH_INDEX={search_index_name | (indexjist) };] 
[MAX_RESULTS=maximum_results;] 
[TIME_LIMIT=time_limit] 

)] 



There are several mechanisms for users to submit federated queries for execution. For 
example, users can create a federated query string and pass it to a federated query object and then 
invoke an execute or evaluate method on that object to trigger the query processing. Altematively, a 
user can pass the federated query string to the execute or evaluate method in the federated datastore to 
process the query directly. The query string will be parsed into a federated query canonical form 
(query expression), which is essentially a datastore neutral representation of the query. In case the 
input query comes from a graphical user interface (GUI) based application, the query does not need to 
be parsed and the corresponding canonical form can be directly constructed. 
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The query canonical form is the input for the federated query processor module. This module 
will perform the following tasks: 

Query translation. Translates the query canonical form into several native queries that 
corresponds to each native datastore associated to this federated datastore . The 
translation information is obtained from the schema mapping. 

Data conversion. Converts data in the query into a native data type for each of the associated 
native datastores. This process uses the mapping and conversion mechanisms described in 
the schema mapping. 

Data filtering. Filters only the relevant data during the construction of native queries. 

Each native query is submitted to the corresponding native datastore for execution. Initially, the 
results returned are cursors to the data in each datastore. 

The end-result of an initial query is a federated result set cursor object, which is a virtual 
collection (i.e., at this time, data has not actually been retrieved) of cursors to objects in each of the native 
datastores. 

The user can retrieve the actual data using a fetch. When a fetch is issued for data, the data is 
returned by the native datastores to the federated query results processor module, which will do the 
following: 

Data conversion. Converts data from the native type into a federated type according to the 
mapping information. 

Data filtering. Filters the results to include only the requested data. 

Result merging. Merges the results from several native datastores into a federated collection. 

The federated result set cursor object provides the facility to separate query results according to 
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the source native datastores. To do such a processing, the user/application may either use the federated 
cursor to fetch data or a native datastore cursor to fetch data from a particular datastore. 

A FederatedQueiy represents and executes queries across heterogeneous datastores. This query 
can be a combination of a DL parametric query, QnDemand query, and other query types involving 
supported datastores. To retrieve data from each datastore, the federated datastore delegates the query 
processing task to each of the native datastores. 



FederatedQuerv.java 

package com ibm,mm.sdk.server; 



public class FederatedQuery implements Query 

{ 

pubhc FederatedQuery(Datastore creator. String queryString); 
public FederatedQuery(FederatedQuery fromQuery); 
public void prepare(NVPair paramsQ); 
public void execute(NVPair params[]); 
pubUc int statusQ; 
public Object resultQ; 
public short qlTypeQ; 
public String queryStringQ; 
public Datastore datastoreQ; 
public dkResultSetCursor resultSetCursorQ; 
pubMc int numberOfResultsQ; 

}; 



Schema Mapping 

A schema mapping represents a mapping between the schema in a datastore with the structure 
of the data-object that the user wants to process in memory. Schema mapping has been generally 
described in U.S. Patent Application Nos. 08/276,382 and 08/276,747, also assigned to BM. 

A federated schema is the conceptual schema of a federated datastore 100, which defines a 
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mapping between the concepts in the federated datastore 1 00 to concepts expressed in each participating 
datastore schema, ha general, a schema mapping handles the difference between how the data are stored 
in the datastore (as expressed by the datastore's conceptual schema) and how the user wants to process 
them in the application program. This mapping can also be extended to incorporate relationship 
5 associations among entities in a federated datastore, e.g., associating an employee's name with the 
appropriate department name. Since the mapping process can be a bit tedious, it is usually done with the 
help of a typical GUI-oriented schema mapping program, 

hi addition to schema-mapping information involving the mapping of entities and attributes, a 
federated datastore 100 must also have access to the following information: 

1 0 User-id and password mapping. To support single sign-on features, each user-id in the federated 

datastore 100 needs to be mapped to its corresponding user-ids in the native datastores. 

Datastore registration. Each native datastore needs to be registered so it can be located and 
; logged-on to by the federated datastore 100 processes on behalf of its users. 

? Messaging Service in a Federated Content Management System 

15 An embodiment of the invention provides a messaging service system. The messaging service 

system provides messaging passing, content forwarding, and event notification in a federated content 
J management system. The messaging service system will leverage the functionality of applications with 

] the messaging capability for independent software vendors (IS Vs) using, for example, an IBM Enterprise 

Information Portal. A portal is a web site or service that offers access to a variety of different resources 
20 and services, such as e-mail and search engines. An enterprise is a large organization that utilizes 
computers. Thus, the IBM Enterprise Information Portal is designed to help corporations leverage the 
vast and growing amount of information supporting e-business apphcations. With the services it 
provides, business users can personalize data queries, search extensively for very specific needs, and 
utilize relevant results -- from across a number of data sources, both traditional and multimedia. 
25 The messaging service system addresses the three problems in conventional federated content 

management systems which lack the following capabiUties: message passing, content forwarding, and 
event notification. 
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A. Client/Server Architecture 

FIG. 5 schematically illustrates a hardware environment of an embodiment of the present 
invention, and more particularly, illustrates a typical distributed computer system using a network 500 
to connect client computers 502 executing client programs to a server computer 504 executing server 
5 software and other computer programs, and to connect the server system 504 to data sources 506. A data 
sowce 506 may comprise, for example, a multi-media database containing items (e.g., video, audio, and 
text items). 

A typical combination of resources may include client computers 502 that are personal computers 
or workstations, and a server computer 504 that is a personal computer, workstation, minicomputer, or 
10 mainframe. These systems are coupled to one another by various networks, including LANs, WANs, 
SNA networks, and the Internet. Each client computer 502 and the server computer 504 additionally 
comprise an operating system and one or more computer programs. 
C J A client computer 502 typically executes a client application and is coupled to a server computer 

Ci 504 executing server software. The cUent application may be a computer program such as a browser, 

yi 5 In FIG. 5, each client computer 502 executes an Enterprise Information Portal (EIP-1 , EIP-2, and EIP-3, 
'j: respectively). 

The server software includes a Messaging Service System 510, which is a computer program for 
^ providing messaging capabilities. The server computer 504 also uses a data source interface and, 

n s possibly, other computer programs, for connecting to the data sources 506. The chent computer 502 is 

JJ;kO bi-directionally coupled with the server computer 504 over a line or via a wireless system. In tum, the 
ri server computer 504 is bi-directionally coupled with data sources 506. 

The data source interface may be connected to a Database Management System (DBMS), which 
supports access to a data source 506 by executing, for example, RDBMS software. The interface and 
DBMS may be located at the server computer 504 or may be located on one or more separate machines. 
25 The data sources 506 may be geographically distributed. 

The operating system and computer programs are comprised of instructions which, when read 
and executed by the client and server computers 502 and 540, cause the chent and server computers 502 
and 540 to perform the steps necessary to implement and/or use the present invention. Generally, the 
operating system and computer programs are tangibly embodied in and/or readable from a device, carrier, 
30 or media, such as memory, other data storage devices, and/or data communications devices. Under 
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control of the operating system, the computer programs may be loaded from memory, other data storage 
devices and/or data communications devices into the memory of the computer for use during actual 
operations. 

Thus, the present invention may be implemented as a method, apparatus, or article of 
manufacture using standard programming and/or engineering techniques to produce software, firmware, 
hardware, or any combination thereof The term "article of manufacture" (or altematively, "computer 
program product") as used herein is intended to encompass a computer program accessible from any 
computer-readable device, carrier, or media. Of course, those skilled in the art will recognize many 
modifications may be made to this configuration without departing from the scope of the present 
invention. 

Those skilled in the art will recognize that the exemplary environment illustrated in FIG. 5 is not 
intended to limit the present invention. Indeed, those skilled in the art will recognize that other alternative 
hardware environments may be used without departing from the scope of flie present invention. For 
example, the server computer 504 may be a federated content management system that is connected to 
heterogeneous data sources, 

B. Overview 

A federated content management system presents a unique challenge for the design of a technique 
for passing messages, forwarding content, and providing event notification, especially because it has 
heterogeneous back-end servers, each of which may store and retrieve different types of content. The 
messaging service system 510 enables messaging capability for a federated content management system, 
regardless of what back-end servers are being used. For example, if EIP-1 at a first client computer 502 
requests a search from a server computer, such as a federated content management system, the results of 
the search may include a Ust of items from multiple servers. In conventional systems, if EIP-2 at a 
second chent computer 502 wanted the same search results, it would have to request another search, 
which is an inefficient use of resources. With the messaging service system 510, EIP-1 can now pass the 
results of its search to EIP-2. 

The messaging service system 510 defines a message structure to organize the text and content 
to be sent and received. In one embodiment, the message structure is presented as a formal grammar. 
A set of object-oriented messaging APIs are defined to allow applications to send and receive messages 
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in a federated content management system. This set of messaging APIs will facilitate the development 
of messaging-based applications. 

The messaging service system 510 allows an application to commimicate with another application 
in a federated content management system, regardless of physical machine locations (e.g., local or 
remote) or implementation languages (e.g., C++, Java, or ActiveX). The messaging service system 510 
enables inter-appHcation communication across heterogeneous back-end servers, which in tum enables 
development of sophisticated messaging-based applications. 

Some aspects of the messaging service system 510 are as follows: 

(1) Message passing - an application can send a message to another appUcation. 

(2) Content forw^ding - an application can forward content of search results to another 
application. 

(3) Event notification - an application can notify another application when an event occurs. 

Messaging plays a crucial role in enterprise computing, for ex^iple, for the IBM Enterprise 
Information Portal in the federated content management space. It is to be understood, however, that the 
concepts of the invention are generally appUcable to any systems that require communication (e.g., 
database products). 

The messaging service system 510 enables a messaging capability for a federated content 
management system via a message structure and a set of object-oriented messaging APIs. The message 
structure is defined to organize the text and content to be sent and received. A set of object-oriented 
messaging APIs are defined to allow applications to send and receive messages in a federated content 
management system. 

FIG. 6 provides an overview of processing with the messaging service system 5 1 0. In block 600, 
under control of a first application program, a message is created. The first apphcation program connects 
to a queue manager, opens a message queue, and puts the message in the message queue, in block 602, 
Then, under control of a second application program, in block 604, a connection is made to a queue 
manager, the message queue is opened, and the message is retrieved fi:om the message queue. Further 
details of this process are provided below. 
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C. Message Structure 

A message consists of a sequence of terms which are separated by a semi-colon A message 
allows any combination of text and/or content. Text is a string of alphanumeric characters; content is a 
list of content identifiers ("IDs"). The length of text is specified in the message structure, along with a 
count (i.e., number) of content IDs. Due to performance and authority considerations, in one 
embodiment, a content ID (rather than, for example, actual content) will be used in the message structure. 
A content ID has two parts: an item identifier ("item ID") and a server name. The item ID is a unique 
identifier of an item in a server, and the server name identifies which server the item belongs to. The item 
ID and its server name together can uniquely identify an item in a federated content management system. 
The following is a message structure that is defined and expressed as a formal grammar below in one 
embodiment of the invention. 

MESSAGE - TEXT_LENGTH; CONTENT_^ID_COUNT; [TEXT;] [CONrENT_ID^LIST] 

where: 

• An uppercase word represents a term 
Brackets ([]) iudicate an optional term 

• A semi-colon (;) is a delimiter 

• An equal operator (=) indicates how a term is defined 

TEXT_LENGTH - Length of the text string 
CONTENT_ID_COUNT = Count of content IDs 
TEXT = String of alphanumeric characters 
CONTENT_ID__LIST = CONTENT_ID; [CONTENT _ID_„LIST] 
CONTENT_ID = ITEM_ID; SERVER_NAME 
ITEM_ID = identifier of an item (i.e., data item) 
SERVER_NAME = Name of a server 
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The following table shows some example combinations of text and content in a message, where 
L is the length of text (1 < L) and N is a number of content IDs, (2 < N): 



Text Length 


Content ID Count 


Usage 


0 


0 


event notification 


0 


1 


one content ID 


0 


N 


multiple content IDs 


L 


0 


text only 


L 


1 


text with one content ID 


L 


N 


text with multiple content 
IDs 



When the text length and content ID count are both zero, the message structure is being used for 
event notification. When, the text length is zero and the content count is a number (i.e., one to N), the 
message structure is being used to forward one or more items (i.e., data items firom a database, including 
without limitation, a list of search results). When the text length is greater than or equal to one, and the 
content ID count is zero, the message structure is being used to pass text. When the text length is greater 
than or equal to one, and the content ID coxmt is a number (i.e., one to N), the message structure is being 
used to forward text and one or more content IDs representing items. 

The following are examples of messages for various combinations of text and content. 

• 0;0; 

The message has no text and there are no content IDs. 

• 0;l;ItemIDl;Serverl; 

The message has no text, but one content ID with item ID = "ItemlDl" and server name = 
"Serverl". 
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• 0;2;ItemBDl; Serverl;ItemID2; Server2; 

The message has no text, but two content IDs with "ItemlOr', "Serverl", and "ItemID2", 
"Server2". 

• 6;0;Hello!; 

The message has a text string "Hello!" of length six and no content IDs. 

• 6; 1 ;Hello ! ;ItemID 1 ;Serverl ; 

The message has a text string "Hello ! " of length six and one content ID with item ID = "ItemID 1 " 
and server name = "Serverl". 

• 6;2;Hello! ;ItemIDl ;Serverl ;ItemID2; Server2; 

The message has a text string "Hello! "of length six and two content IDs with "ItemlDl", 
"Serverl", and "ItemID2", "Server2". 

D. Object-Oriented Messaging API 

The messaging service system 510 provides a set of object-oriented messaging APIs. In one 
embodiment, the object-oriented messaging APIs consist of two classes: DKMessagingService and 
DKMessageObject. Additionally, in one embodiment, the messaging service system 510 integrates the 
IBM Message Queue technology with an IBM Eff object-oriented API framework. It is to be 
understood, however, that the concepts of the invention are applicable to any message transfer or queuing 
technology. 

The DKMessagingService class defines a set of basic messaging services including connect, 
disconnect, open queue, close queue, and put/get message. A typical scenario is that an appUcation 
connects to a queue manager, opens a queue, puts or gets a message, closes a queue, and disconnects from 
the queue manager. In one embodiment, the message in the message queue will follow the FIFO (First- 
In, First-Out) principle. 
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The following is an example DKMessagingService class definition for one embodiment of the 
invention: 

class DKMessagingService 

{ 

pxiblic: 

DKMessagingService Q; 
-DKMessagingServiceQ; 

void connect (const char* queue_manager)'; 
void disconnect Q; 

void openQueue (const char* queue); 

void closeQueue Q; 

DKString queryManagerNameQ; 

void putMessage (DKMessageObject* message); 

DKMessageObject* getMessage Q; 

}; 

The following are the methods of the DKMessagingService class: 

• DKMessagingServiceQ - This is the constructor of DKMessagingService. 

• -DKMessagingServiceQ - This is the destructor of DKMessagingService. 

• void connect(const char* queue_manager) - This method allows an application to connect to the 
specified queue manager. Li one embodiment, only one query manager can be connected at a 
time. 

• void disconnectQ - The method disconnects an application firom a queue manager. 

• void openQueue(const char* queue) - This method opens the specified queue in a connected 
queue manager, hi one embodiment, only one query can be opened at a time. 

• void closeQueueQ - The method closes an opened queue. 

• DKString queryManagerNameQ - This method returns the name of the query manager, if 
connected. Otherwise, an empty string will be returned. 
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• void putMessage(DKMessageObject* message) - The method puts a message into an opened 
queue. The message is represented as a DKMessageObject object. 

• DKMessageObject* getMessageQ - The method gets a message from an opened queue. The 
message is represented as a DKMessageObject object. 

The DKMessagObj ect class defines the obj ect-oriented representation of a message based on the 
message structure mentioned earher. A DKMessageObject can be created by using one of the two 
constructors. Several access methods are also available to get the length of text, count of content IDs, 
string of text, list of content IDs, and the string of message. 

The following is an example DKMessagObj ect class definition for one embodiment of the 
invention: 

class DKMessageObject 

{ 

pubhc: 

DKMessageObject (const char * text, dkCoUection* content_id_hst); 

DKMessageObject (const char * message); 

--DKMessageObject Q; 

long getTextLength Q; 

DKString getText Q; 

long getContentlDCountO; 

dkCoUection* getContentlDListO; 

DKString getMessageStringQ; 

}; 

The following are the methods of the DKMessageObject class: 

• DKMessageObject (const char * text, dkCoUection* content_id_Ust) - This is a constructor of 
DKMessageObject with two parameters: a string of text and a Ust of content IDs. This constructs 
a message to be sent or received. 
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• DKMessageObject (const char * message) - This method constructs a DKMessageObject based 
on the specified message that follows the message structure. 

• -DKMessageObjectO - This is the destructor of DKMessageObject. 

• long getTextLengthO - The method returns the length of text in the message. A zero means no 
text is kept in the message. 

• DKString getTextQ - The method retrieves the text in the message, if any. Otherwise, an empty 
string will be returned. 

• long getContentlDCountQ - This method returns the count of content IDs in the Ust. A zero 
means no content JD is kept in the message. 

• dkCoUection* getContentlDListQ - This method gets a Ust of content IDs. Each content ID is 
a pair of an item ID and its server name. 

• DKString getMessageStringO - The method retums the message as a string. 

The following is sample psuedocode that provides an example of putting a message in a queue, 
with comments following the asterisks: 

DKMessagingService* ms; define a pointer for ms 

DKMessageObject* message; define a pointer for message 

ms = new DKMessagingServiceQ; instantiate DKMessagingServiceQ object 

ms->connect ("SANJOSE.QUERY.MANAGER"); ***connect to a queue manager 

cout « "Query manager name is = " « ms->queiyManagerName Q « endl; *** print name 

ms->openQueue ("SYSTEM.DEFAULT.LOCAL.QUEUE"); open a queue 

message = new DKMessageObject ("Hello!", NULL); instantiate DKMessageObject object 

ms->putMessage (message); *** put a message in the queue 

delete message; *** delete the pointer for message 

ms->closeQueueO; close the queue 

ms->disconnectO; *** disconnect fi-om the queue manager 

delete ms; delete the pointer for ms 
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The above application program defines (e.g., allocates memoiy to) pointers (i.e., ms and message) 
and instantiates a DKMessagingService object. In order to put a message into a queue, the application 
program first connects to a query manager, for example "SANJOSE.QUERY.MANAGER". 
Additionally, the apphcation program displays the name of the query manager. Then it opens a queue, 
5 for example "SYSTEM.DEFAULT.LOCAL.QUEUE". ADKMessageObject object is instantiated, and 
a message is constructed with a text "Hello ! " and no content ID. Next, the application program puts the 
message into the queue. The application program deletes (e.g., deallocates memory for) the pointer for 
message. The application program closes the queue and disconnects fi:*om the queue manager. Finally, 
the application program deletes (e.g., deallocates memory for) the pointer for ms. 
1 0 The following is sample psuedocode that provides an example of getting a message fi-om a queue, 

with comments following the asterisks: 

Q DKMessagingService* ms; *** define pointer for ms 

DKMessageObject* message; *** define pointer for ms 
111 ms = new DKMessagingService Q; instantiate DKMessagingService Q object 
Jt 5 ms->connect ("SANJOSE.QUERY.MANAGER"); *** connect to a queue manager 
^ cout << "Query manager name is = " « ms->queryManagerName Q « endl; *** print name 

ms->openQueue ("SYSTEM.DEFAULT.LOCAL.QUEUE"); open a queue 
jl j message = ms->getMessage Q; *** get a message Scorn the queue 

g cout << "Text is = " << message->getText Q << endl; *** print text message 

rpO delete message; delete the pointer for message 
" ' ms->closeQueueO; *** close the queue 

ms->disconnectO; disconnect from the queue manager 

delete ms; *** delete the pointer for ms 

The above application program defines (e.g., allocates memoiy to) pointers (i.e., ms and message) 
25 and instmtiates a DKMessaging Service object. In order to get a message from a queue, the application 
program first connects to a query manager, for example "SANJOSE.QUERY.MANAGER". 
Additionally, the apphcation program displays the name of the query manager. Then it opens a queue, 
for example "S YSTEM,DEFAULT.LOCAL.QUEUE". A message is retrieved fi-om the queue, and the 
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text of the message is printed. The application program deletes (e.g., deallocates memory for) the pointer 
for message. The application program closes the queue and disconnects from the queue manager. 
Finally, the application program deletes (e.g., deallocates memory for) the pointer for ms. 

Conclusion 

This concludes the description of embodiments of the invention. The following describes some 
altemative embodiments for accompUshing the present invention. For example, any type of computer, 
such as a mainframe, minicomputer, personal computer, mobile device, or embedded system, or computer 
conifiguration, such as a timesharing mainframe, local area network, or standalone personal computer, 
could be used with the techniques of the present invention. 

The foregoing description of embodiments of the invention has been presented for the purposes 
of illustration and description. It is not intended to be exhaustive or to limit the invention to the precise 
forms disclosed. Many modifications and variations are possible in hght of the above teaching. It is 
intended that the scope of the invention be limited not by this detailed description, but rather by the 
claims appended hereto. 
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